home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / STFX-soundsystemdisk.adf / docs / track.doc(doc2.2) < prev    next >
Text File  |  1988-01-20  |  12KB  |  317 lines
  1. Note: This SoundTracker is based on the MasterSoundTracker V1.0 by TIP/AGENTS
  2.  
  3. D.O.C-SoundTracker 2.2 - A Quick Clarification.
  4. ----------------------------------------------
  5.  
  6. Update         : Dezember-1988.
  7.  
  8. Update done by : UNKNOWN of DOCTOR MABUSE ORGASM CRACKINGS (D.O.C)
  9.  
  10. INSTRUCTIONS   : TRACER and UNKNOWN of D.O.C / Based on J.C.-Instructions
  11. -----------------------------------------------------------------------------
  12.  
  13. Modifications by D.O.C:
  14. -----------------------
  15.  
  16.                A sample sort function
  17.                Corrected 'DisplayPattern' routine
  18.                Corrected preset-editor
  19.                Improved record function
  20.                Extended keymap (Sonix style)
  21.                Pattern play function
  22.                Delete Song function in the dos menu
  23.                Improved ANALYZER
  24.                Pattern changing during play
  25.                Pattern break command !!!! 
  26.                Position jump command !!!! 
  27.                Sample zero function 
  28.                New playroutine for use in demos/intros/games
  29.                Improved graphics (colors,styling,font)
  30.                Nice scrolling
  31.                Animated mousepointer
  32.            Directory Sort function
  33.                New Colors for the Analyser
  34.  
  35. Patterns.
  36. ---------
  37.  
  38. Any piece of music written with SoundTracker 2.2 is build up from patterns.
  39. SoundTracker holds a table with information about the sequence in which
  40. these parts must be played. With 'Position' you determine your position
  41. in the table. With 'Pattern' you define what pattern to play at that
  42. position. 'Length' defines the total size of the table.
  43.  
  44.  
  45. The Keys.
  46. ---------
  47.  
  48. The original (V1.8) version of the SoundTracker had a German keymap.
  49. Version 2.2 supports a standard USA keymap and this ensures compatibility
  50. with ALL Amigas.
  51. The keyboard has been extended, try typing on the whole key-rows.
  52. The keys on your Amiga have been grouped to represent the layout of a
  53. two-octave piano-keyboard. You can "shift" the keyboard one octave up or
  54. down with the aid of the F1 and F2 keys, this incrementing the range of
  55. the keyboard to three octaves.
  56.  
  57. While editing:
  58. --------------
  59.                Cursor-keys move cursor.
  60.        shift + Cursor-keys move cursor fast.
  61.          alt + Cursor-keys move cursor fastest.
  62.                F6  - Set cursor to first line of pattern.
  63.                F7  - Set cursor to 16th line of pattern.
  64.                F8  - Set cursor to 32th line of pattern.
  65.                F9  - Set cursor to 48th line of pattern.
  66.                F10 - Set cursor to last line of pattern.
  67.                DEL - Delete note under cursor.
  68.        shift + F3  - Cut track of current pattern and copy into copy-puffer.
  69.        shift + F4  - Copy track of current pattern into copy-puffer.
  70.        shift + F5  - Copy puffer to track of current pattern.
  71.          alt + F3  - Cut the whole pattern and copy into copy-buffer.
  72.          alt + F4  - Copy pattern into copy-puffer.
  73.          alt + F5  - Copy puffer to current pattern.
  74.       
  75.  
  76. Special keys:
  77. ------------
  78. To quit the D.O.C-SoundTracker 2.2 point the mousepointer at 0,0 and press:
  79.  
  80.          alt + shift + left and right mousebutton together !!!!
  81.  
  82.  
  83. Sample sort function:
  84. ---------------------
  85. I've inserted a special sort function in the load-song routine, so you
  86. needn't to be a DJ anymore.
  87.  
  88. Only the D.O.C-SoundTrackers 2.1 + 2.2 will load ALL Samples from the 
  89. Disk 'ST-01', than from 'ST-02', than from 'ST-03' and so on.
  90.  
  91. Sample zero function:
  92. ---------------------
  93. While edding-ting you're able to set the sample to the value zero (0!).
  94. Press all mousebuttons (three at all) at the position of the sample-
  95. gadgets (plus,minus = +,-). Now you can edit the pattern with the
  96. sample 0 to prevent difficulties according to the volume (Frog's idea) !!!
  97.  
  98.  
  99. Correct 'DisplayPattern' routine:
  100. ---------------------------------
  101. The 'MasterSoundTracker V1.0' and the 'D.O.C-SoundTracker V2.0' had
  102. a incorrect 'DisplayPattern' routine !!!  The highest bit of the command-
  103. and infobyte had been deleted on screen, but not in the memory !!!!!!!!!!
  104. I've discovered this bug and removed it.
  105.  
  106. Example:           Entered -  E-2 C2FF   <=- Correct !
  107.          Printed out later -  E-2 427F   <=- Wrong instrument and infobyte !
  108.            Still in memory -  E-2 C2FF   <=- Correct !
  109.  
  110.  
  111. Instruments.
  112. ------------
  113. You can use up to fifteen different instruments in one music-piece.
  114. All instruments are listed in the preset-list. The volume is allways
  115. 64 but you can change it to each value between 0 and 64.
  116. To change the other values of each instrument you have to load the
  117. preset-editor. With that tool you can change the whole preset-list.
  118. TIP improved the preset-editor : some values (Length,Repeat and RepeatLength)
  119. have to be entered in hexadecimal !!! Now you can use samples up to
  120. $8000 (=32768) bytes !!!! (Press right mouse-button to quit).
  121.  
  122. UNKNOWN corrected the preset-editor : It got a nice bug !  (Not TIP's fault)
  123.  
  124. Example: You've an instrument called 'HeavySynth' in your preset-list, now
  125.          you want to INSERT an instrument with the name 'Heavy' in it.
  126.          The preset-editor searches for the word 'HEAVY' in the list, find
  127.          the name 'HEAVYsynth' and DELETES it to insert the name
  128.          'Heavy' !!!!!!!!!!!!!
  129.  
  130. Of course I've discoverd and removed this bug, too.
  131.  
  132.  
  133. Notes:
  134. ------
  135.                C#1   3 C 2 3
  136.                /    /  |  \|
  137.               /    /   |   Arpeggio,portamento,volume,speed,filter and 
  138.              /    /  Command                                   position info.
  139.             /   Inst#
  140.          Note to
  141.          be played.
  142.  
  143.  
  144.  
  145. Note:     This is simply the note that must be played by that particular
  146. -----     instrument.
  147.  
  148. Inst#:    This is the number of the instrument that must be used to play
  149. ------    the note. When the instrument number is zero, the last selected
  150.           instrument will be used.
  151.  
  152. Command:  This number tells SoundTracker what special functions must be
  153. --------  preformed while playing the note.
  154.  
  155. These functions are as follows:
  156.  
  157.      0 - Normal play or arpeggio.
  158.      1 - Portamento up.
  159.      2 - Portamento down.
  160.      B - Position jump!
  161.      C - Set volume.
  162.      D - Pattern break!
  163.      E - Set filter on/off
  164.      F - Set speed.
  165.  
  166. Info:      This byte contains the additional information for the commands.
  167. -----     
  168.  
  169. Arpeggio:  Arpeggio is used for simulating accords. It does this by
  170. ---------  rapidly changing the notes while playing an instrument.
  171.            Arpeggios are selected whenever the info byte has a non-zero
  172.            value and no other commands are selected.
  173.            When arpeggios are used, SoundTracker looks five times during
  174.            the play of one note, at the information contained in the info
  175.            byte. Each nibble (4 bits) in this byte defines
  176.            how many notes SoundTracker must add to the the note currently
  177.            playing. In each of the five passes SoundTracker does the
  178.            following with the information contained in the info byte :
  179.        
  180.            1 - Add the first nibble to the current note.
  181.  
  182.            2 - Add the second nibble to the current note.
  183.  
  184.            3 - Play the current note.
  185.  
  186.            4 - Add the first nibble to the current note.
  187.  
  188.            5 - Add the second nibble to the current note.
  189.  
  190.  
  191. Portamento:  Portamento is used for 'sliding' of the instrument.
  192. -----------  If portamento is in use, the information contained in
  193.              the info byte will be added to (or subtracted from) the period
  194.              of the note playing in each of the five passes.
  195.  
  196.    Example:  D#2 3208  Slides down $08
  197.              --- 0208  Slides down $08
  198.              --- 0108  Slides up $08
  199.              --- 0210  Slides down $10 (=16)
  200.              etc.
  201.  
  202.    
  203. Position jump:
  204. --------------
  205.          The position jump command will do the same like the pattern break
  206.          command, but the info byte gives the playroutine the no. of the
  207.          position.
  208.  
  209. Example: E-2 3B04 - Break the pattern and jump to position 4
  210.          --- 0000
  211.          --- 0B06 - Break the pattern and jump to position 6
  212.  
  213.  
  214. Volume:  One of the enhancements that the V2.2 version provides is the
  215. -------  ability to change the volume at any time during play.
  216.          When command $0C (=12) is selected, the volume is set to the value
  217.          contained in the info byte. The volume will remain at this level
  218.          until a next SAMPLE is played. At this time, the volume is
  219.          reset to the default volume level of that sample.
  220.  
  221. Example: C#1 1C22 - Set volume to $22 (=34) and use instrument # 1 to
  222.                     play the C#1 note.
  223.          D-2 0000 - Use instrument # 1 to play the D-2 note.
  224.                     (Volume level remains at $22 (=34))
  225.          B-1 1000 - Use instrument # 1 to play the B-1 note and
  226.                     set volume to default value for that
  227.                     instrument.
  228.  
  229. Pattern break:
  230. --------------
  231.          Pattern break is used to create shorter patterns than 64 notes.
  232.          The note with the $0D command will be played and after that
  233.          the next pattern in the position-table will be played.
  234.  
  235. Example: A#3 1D00 - At this point the pattern interrupts.
  236.          --- 0D00 - Look upper line.
  237.          C-1 0D30 - Look upper line.
  238.  
  239.  
  240. Filter:  This Soundtracker version allows you to turn the lo-pass filter
  241. -------  on/off.
  242.  
  243. Example: G#2 1E01 - Turns the filter and the power-led off.
  244.          --- 0000
  245.          E-1 1E00 - Turns the filter and the power-led on.
  246.  
  247. Warning to all Amiga 1000 owners (like Unknown and Esteban):
  248. Don't play with the power-led because some A500 and A2000 owners will
  249. not be happy when they hear your song.
  250.  
  251.  
  252. Speed:   This function allows changing the speed during play.
  253. ------   You can only enter a speed between 01 and 0F.
  254.          Setting the info byte to zero doesn't effect anything.
  255.          The normal speed is 6.
  256.  
  257. Example: D-2 4F04 - Set speed to 4
  258.          --- 0000
  259.          E-1 0F00 - Nothing happens to speed.
  260.          --- 0FC3 - Set speed to 3
  261.          G-2 2F06 - Set normal speed
  262.  
  263.          If you load another song it will be played with the actual speed.
  264.          All songs on these disk are re-written to their normal speeds.
  265.          (by D.O.C)
  266.  
  267. The Playroutine.
  268. ----------------
  269. The playroutine on the SoundTracker disk is for using your music in demos,
  270. intros, games etc. It was written using the Seka-assembler and the source
  271. of the routine can directly be incorporated in your demo/intro source.
  272. When you are finished writing your music using D.O.C-SoundTracker, save it
  273. to Disk. Use the function 'SAVE MODULE'. You will find at the 'MODULES'-DIR
  274. a file, which contains all muzakdatas and instruments. Load with SEKA
  275. the source of the playroutine and enter the size of saved module at the
  276. label 'mt_data'.
  277. Assemble. Now load the saved module to 'mt_data'.
  278.  
  279. How to play a song:
  280. -------------------
  281. At the beginning of your program, call the 'mt_init' routine.
  282. Each vertical blank jump to the 'mt_music' routine.
  283. To stop the song jump to the 'mt_end' routine.
  284.  
  285. Please note that the V2.2 version of D.O.C-SoundTracker is completely 
  286. downwards compatible with version V9.
  287. --------------------------------------------------------------------------
  288.  
  289. If you think the D.O.C-SoundTracker V2.2 is the Best and D.O.C is great
  290. then write to the following Address :
  291.  
  292.    D.O.C (Don't write this line)
  293.    PLK 088231 C
  294.    2350 NEUMUENSTER 1
  295.    WEST-GERMANY
  296.  
  297. -------------------------------------------------------------------------
  298.  
  299. ADDITIONAL INFORMATIONS AND HINTS :
  300.  
  301. - SOME INSTRUMENTS HAD BEEN CHANGED AND SOME HAD BEEN REPLACED
  302.   FOR OTHER INSTRUMENTS (FROM K. OBARSKI)
  303.  
  304. - CAUSE OF DISK-SPACE ON SECOND INSTRUMENT DISK UNKNOWN AND TRACER COPIED
  305.   SOME INSTRUMENTS FROM THEIR MUSIC-RIPPS TO IT.
  306.   THE MAIDEN VERSION CONTAINS 258 INSTRUMENTS AT ALL.
  307.   THIS NEW VERSION CONTAINS CA.420 INSTRUMENTS !!!
  308.  
  309. - THIS SOUNDTRACKER-VERSION CONTAINS FIVE DISKS AT ALL!
  310.   (ONE SONG DISK,FOUR INSTRUMENT DISKS)
  311.  
  312. - HINT :
  313.  
  314.   CONTACT D.O.C !! (But not, if 'ya are a LOSER or a LAMER or BOTH !!!!?)
  315.  
  316. ----------------------------------------------------------------------------
  317.